home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 April / EnigmA AMIGA RUN 17 (1997)(G.R. Edizioni)(IT)[!][issue 1997-04][EAR-CD].iso / EARCD / text / hyper / hsc.readme < prev    next >
Text File  |  1997-01-05  |  11KB  |  257 lines
  1. Short:    Html-preprocessor (v0.911)
  2. Author:   Thomas Aglassinger <agi@giga.or.at>
  3. Uploader: Thomas Aglassinger <agi@giga.or.at>
  4. Version:  0.911
  5. Type:     text/hyper
  6. Kurz:     Entwicklerwerkzeug fuer HTML
  7. Requires: AmigaOS 2.04, 68020, 2MB
  8.  
  9. TITLE
  10.  
  11.   hsc - html sucks completely
  12.  
  13. VERSION 
  14.  
  15.   0.911
  16.  
  17. AUTHOR
  18.  
  19.   Thomas Aglassinger <agi@giga.or.at>
  20.  
  21. DESCRIPTION
  22.  
  23.   hsc is a developer tool for html projects.
  24.  
  25.   It can be used on any html file and creates a new html file as
  26.   output. In the input file, you may use an extended syntax based
  27.   on html, but which also allows things like macros and
  28.   conditionals.
  29.  
  30.   It's mainly intended to create and maintain larger html projects.
  31.   As a CLI-only tool, it should be used with `make'; a 
  32.   dependecy generator is included.
  33.  
  34.   hsc is *not* a tool to make html easier for beginners; It's a
  35.   tool to make html a bit less painful and braindamaged for
  36.   people who already know how to work with it.
  37.  
  38. FEATURES
  39.  
  40.   o adds some special tags, for example to
  41.     o include files (also sources)
  42.     o execute shell commands during conversion
  43.     o add comments in a reasonable way
  44.   o supports macros (implemented as additional tags)
  45.   o conditionals (if/else/elseif)
  46.   o simple expressions can be passed as values to attributes (like
  47.     string concatenation, string comparison, import of environment-
  48.     variables, current time or filesize)
  49.   o for local links, checks if file/id exists
  50.   o maintains a project-file to check existence of id's over all 
  51.     files processed
  52.   o supports absolute URIs (relative to root directory of project)
  53.   o replaces special characters by entities
  54.   o evaluates attributes for image size
  55.   o strips comments and specified tags
  56.   o strips useless white spaces
  57.   o replaces icon entities by images
  58.   o performs a (small) syntax- and structure-check
  59.   o easy to extend syntax-definition format
  60.   o dependency generator for Makefiles included
  61.  
  62. NEW FEATURES
  63.  
  64.   o some bugfixes (as usual)
  65.   o tool to examine/manipulate project files included
  66.   o improved handling of white spaces
  67.  
  68. SPECIAL REQUIREMENTS
  69.  
  70.   AmigaOS 2.04, 2MB of regular memory, 68020, some sort of 
  71.   WWW browser and ASCII editor.
  72.   For larger projects, 4MB of memory and 68040 are recommded.
  73.  
  74.   Different to most other WWW tools, hsc requires an user-IQ > 50.
  75.  
  76. AVAILABILITY
  77.  
  78.   o Every Aminet-mirror, file "text/hyper/hsc.lha"; for example
  79.     "ftp://wuarchive.wustl.edu/pub/aminet/text/hyper/hsc.lha"
  80.   o "http://www.giga.or.at/~agi/hsc/index.html"
  81.  
  82. PRICE
  83.  
  84.   Freeware.
  85.  
  86. DISTRIBUTABILITY
  87.  
  88.   Distributed under GNU General Public License.
  89.  
  90. SOURCE CODE
  91.  
  92.   ANSI-C source-code is available in a separate archive (look for
  93.   `hsc-source.lha' at the same site you've got the binaries from).
  94.  
  95.  
  96. ============================= Archive contents =============================
  97.  
  98. Original  Packed Ratio    Date     Time    Name
  99. -------- ------- ----- --------- --------  -------------
  100.       26      26  0.0% 04-Dec-96 22:11:30  FILE_ID.DIZ
  101.      628     273 56.5% 07-Sep-96 00:18:54  hsc.info
  102.    17662    7078 59.9% 04-Dec-96 03:19:16 +CHANGES
  103.      463     238 48.5% 06-Sep-96 22:51:12 +CHANGES.info
  104.    17982    6993 61.1% 26-Jun-95 08:31:52 +COPYING
  105.      463     236 49.0% 06-Sep-96 22:51:12 +COPYING.info
  106.      628     274 56.3% 10-Sep-96 13:12:28 +docs.info
  107.     4065    1910 53.0% 04-Dec-96 02:47:50 +about.html
  108.     6224    2718 56.3% 04-Dec-96 02:50:06 +author.html
  109.     5132    2362 53.9% 04-Dec-96 02:50:46 +bugs.html
  110.     1967     908 53.8% 04-Dec-96 02:47:56 +copy.html
  111.     3578    1401 60.8% 04-Dec-96 02:57:14 +distrib.html
  112.     2109     913 56.7% 04-Dec-96 02:50:32 +envvar.html
  113.     1913     850 55.5% 04-Dec-96 02:48:02 +examples.html
  114.     2669    1104 58.6% 04-Dec-96 02:48:22 +absuris.html
  115.     1744     753 56.8% 04-Dec-96 02:50:12 +checkuri.html
  116.     8121    2927 63.9% 04-Dec-96 02:46:30 +exec.html
  117.     4605    1669 63.7% 04-Dec-96 02:46:44 +expressions.html
  118.     2849    1143 59.8% 04-Dec-96 02:49:14 +getsize.html
  119.     4700    1691 64.0% 04-Dec-96 02:48:28 +if.html
  120.     6120    2566 58.0% 04-Dec-96 02:48:34 +prefs.html
  121.     2239    1055 52.8% 04-Dec-96 02:48:40 +rplcent.html
  122.    12629    3572 71.7% 04-Dec-96 02:49:08 +spcattr.html
  123.     7853    2865 63.5% 04-Dec-96 02:46:22 +spctags.html
  124.     3379    1418 58.0% 04-Dec-96 02:48:58 +strip.html
  125.     1870     817 56.3% 04-Dec-96 02:47:00 +syntax.html
  126.     5921    2270 61.6% 04-Dec-96 02:49:40 +fileargs.html
  127.     3278    1468 55.2% 04-Dec-96 02:46:54 +future.html
  128.      138     138  0.0% 14-Jan-96 17:27:46 +back.gif
  129.      190     190  0.0% 14-Jan-96 17:20:08 +copy.gif
  130.      496     496  0.0% 16-Jan-96 18:59:32 +head.gif
  131.      638     638  0.0% 26-May-96 02:10:44 +hsc.gif
  132.      170     170  0.0% 14-Jan-96 17:14:34 +index.gif
  133.      176     176  0.0% 14-Jan-96 17:14:44 +main.gif
  134.      189     189  0.0% 14-Jan-96 17:15:02 +next.gif
  135.      347     347  0.0% 12-Oct-96 18:51:36 +niceguy.gif
  136.      168     168  0.0% 14-Jan-96 17:28:12 +noback.gif
  137.      211     211  0.0% 14-Jan-96 17:20:36 +nocopy.gif
  138.      200     200  0.0% 14-Jan-96 17:15:28 +noindex.gif
  139.      193     193  0.0% 14-Jan-96 17:15:40 +nomain.gif
  140.      212     212  0.0% 14-Jan-96 17:15:52 +nonext.gif
  141.      213     213  0.0% 15-Jul-96 23:44:28 +noprev.gif
  142.      188     188  0.0% 14-Jan-96 17:16:08 +prev.gif
  143.      141     141  0.0% 04-Nov-95 02:20:36 +up.gif
  144.     6572    2344 64.3% 04-Dec-96 02:50:20 +index.html
  145.      468     253 45.9% 10-Sep-96 13:12:14 +index.html.info
  146.     2942    1237 57.9% 04-Dec-96 02:49:46 +install.html
  147.     4898    1752 64.2% 04-Dec-96 02:47:08 +attrib.html
  148.     4705    1691 64.0% 04-Dec-96 02:47:14 +flag.html
  149.     4735    1942 58.9% 04-Dec-96 02:47:24 +macros.html
  150.    24307    7470 69.2% 04-Dec-96 02:50:00 +messages.html
  151.    12579    4833 61.5% 04-Dec-96 02:50:40 +options.html
  152.     4003    1768 55.8% 04-Dec-96 02:50:26 +ports.html
  153.     3541    1410 60.1% 04-Dec-96 02:49:32 +hscdepp.html
  154.     5336    1991 62.6% 04-Dec-96 02:50:52 +hscpitt.html
  155.     1805     699 61.2% 04-Dec-96 02:49:26 +index.html
  156.     1935     840 56.5% 04-Dec-96 02:47:44 +make.html
  157.     4668    1855 60.2% 04-Dec-96 02:47:38 +makefile.html
  158.     3000    1271 57.6% 04-Dec-96 02:47:30 +prjfile.html
  159.     7675    3026 60.5% 04-Dec-96 02:49:20 +questions.html
  160.     3637    1552 57.3% 04-Dec-96 02:48:52 +related.html
  161.     2703    1248 53.8% 04-Dec-96 02:48:10 +require.html
  162.     2169     997 54.0% 04-Dec-96 02:48:16 +source.html
  163.     2079     839 59.6% 04-Dec-96 02:46:36 +updates.html
  164.      628     273 56.5% 10-Sep-96 13:12:28 +example.info
  165.       55      55  0.0% 04-Dec-96 22:11:32 +README
  166.     2155     920 57.3% 09-Sep-96 07:48:52 +README
  167.      463     237 48.8% 10-Sep-96 13:12:08 +README.info
  168.      347     347  0.0% 12-Oct-96 18:51:36 +hugo.gif
  169.      217     172 20.7% 23-Oct-95 02:54:30 +hugo.hsc
  170.     1104     514 53.4% 30-Sep-96 04:55:44 +macro.hsc
  171.      398     257 35.4% 23-Jul-96 14:13:18 +main.hsc
  172.      747     353 52.7% 23-Jul-96 14:08:48 +Makefile
  173.      178     139 21.9% 16-Sep-95 23:32:32 +stupid.hsc
  174.      628     275 56.2% 06-Sep-96 22:52:28 +grafflwerk.info
  175.     3173    1496 52.8% 30-Jul-96 12:47:06 +hScMsg.rexx
  176.      513     301 41.3% 06-Sep-96 22:52:24 +hScMsg.rexx.info
  177.     1254     635 49.3% 18-Aug-96 08:29:26 +Makefile
  178.      464     229 50.6% 06-Sep-96 22:52:24 +Makefile.info
  179.     1177     558 52.5% 12-Oct-96 16:45:50 +README
  180.      463     238 48.5% 06-Sep-96 22:52:24 +README.info
  181.     2081    1052 49.4% 03-Aug-96 19:13:32 +SendAWeb.rexx
  182.      513     298 41.9% 06-Sep-96 22:52:24 +SendAWeb.rexx.info
  183.     3337    1507 54.8% 04-Aug-96 23:27:42 +SendScMsg.rexx
  184.      513     301 41.3% 06-Sep-96 22:52:24 +SendScMsg.rexx.info
  185.      616     390 36.6% 12-Nov-96 10:26:26 +Hmpf_Grmbl_Wrcks
  186.      463     238 48.5% 06-Sep-96 22:51:12 +Hmpf_Grmbl_Wrcks.info
  187.    92052   52333 43.1% 04-Dec-96 02:44:50 +hsc
  188.      467     206 55.8% 10-Sep-96 13:24:06 +hsc.info
  189.    14650    3672 74.9% 27-Oct-96 19:02:54 +hsc.prefs
  190.    42860   24660 42.4% 04-Dec-96 02:09:34 +hscdepp
  191.      467     210 55.0% 19-Oct-96 22:27:36 +hscdepp.info
  192.    42416   24482 42.2% 04-Dec-96 02:45:54 +hscpitt
  193.      467     210 55.0% 19-Oct-96 22:27:36 +hscpitt.info
  194.      660     414 37.2% 12-Oct-96 15:35:32 +IMPORTANT
  195.      463     241 47.9% 06-Sep-96 22:51:12 +IMPORTANT.info
  196.     2475    1332 46.1% 04-Dec-96 22:11:32 +README
  197.      463     238 48.5% 06-Sep-96 22:51:12 +README.info
  198.      628     276 56.0% 10-Sep-96 13:12:28 +src_docs.info
  199.     3137    1639 47.7% 04-Dec-96 02:08:34 +about.hsc
  200.     5199    2467 52.5% 04-Dec-96 02:07:36 +author.hsc
  201.     4248    2104 50.4% 04-Dec-96 02:33:14 +bugs.hsc
  202.     1140     666 41.5% 14-Jul-96 21:59:54 +copy.hsc
  203.      340     230 32.3% 12-Sep-96 06:59:34 +credits.hsc
  204.     2500    1143 54.2% 10-Nov-96 23:35:58 +distrib.hsc
  205.     1156     655 43.3% 17-Nov-96 18:48:02 +envvar.hsc
  206.     1179     649 44.9% 30-Sep-96 04:05:22 +examples.hsc
  207.      154     133 13.6% 03-Jun-96 21:21:32 +anchor.hsc
  208.      264     167 36.7% 10-Nov-96 03:17:46 +exec.hsc
  209.      257     165 35.7% 20-Dec-95 03:43:58 +expression.hsc
  210.       45      45  0.0% 24-Oct-95 00:27:36 +m_addr.hsc
  211.      104      71 31.7% 12-May-96 23:07:52 +m_file.hsc
  212.      102     101  0.9% 04-Dec-95 04:02:52 +m_next.hsc
  213.      244     156 36.0% 19-Jul-96 22:37:36 +operators.hsc
  214.     1679     826 50.8% 29-May-96 02:24:48 +absuris.hsc
  215.      779     457 41.3% 17-Nov-96 18:32:12 +checkuri.hsc
  216.     6514    2443 62.4% 10-Nov-96 03:16:44 +exec.hsc
  217.     3749    1399 62.6% 13-Oct-96 14:21:30 +expressions.hsc
  218.     1774     881 50.3% 16-Oct-96 16:35:30 +getsize.hsc
  219.     3636    1430 60.6% 13-Oct-96 14:46:30 +if.hsc
  220.     4913    2306 53.0% 04-Dec-96 02:24:00 +prefs.hsc
  221.     1262     761 39.6% 23-Jul-96 11:05:38 +rplcent.hsc
  222.    10869    3217 70.4% 10-Nov-96 23:42:02 +spcattr.hsc
  223.     8546    3233 62.1% 24-Nov-96 18:02:34 +spctags.hsc
  224.     2204    1104 49.9% 10-Nov-96 23:41:38 +strip.hsc
  225.      866     522 39.7% 23-Jul-96 10:49:10 +syntax.hsc
  226.     4962    1989 59.9% 10-Nov-96 03:49:56 +fileargs.hsc
  227.     2341    1198 48.8% 04-Dec-96 02:36:32 +future.hsc
  228.     7807    1649 78.8% 04-Dec-96 02:57:14 +hsc.project
  229.     5377    1373 74.4% 24-Nov-96 17:46:56 +macro.hsc
  230.     2933     893 69.5% 06-Aug-96 00:07:30 +webpage.hsc
  231.     6558    2466 62.3% 04-Dec-96 02:01:06 +index.hsc
  232.     1963     936 52.3% 06-Nov-96 21:16:26 +install.hsc
  233.     3470    1532 55.8% 10-Nov-96 03:23:44 +attrib.hsc
  234.     3382    1451 57.0% 10-Nov-96 03:25:38 +flag.hsc
  235.     3746    1696 54.7% 10-Nov-96 03:30:06 +macros.hsc
  236.     2622    1224 53.3% 04-Dec-96 03:09:16 +main_index.hsc
  237.     5882    1472 74.9% 24-Nov-96 15:18:58 +Makefile
  238.     5978    1486 75.1% 17-Nov-96 02:43:12 +Makefile.bak
  239.    20446    7131 65.1% 04-Dec-96 02:18:08 +messages.hsc
  240.    12038    4856 59.6% 04-Dec-96 02:15:10 +options.hsc
  241.     2972    1455 51.0% 17-Nov-96 18:43:02 +ports.hsc
  242.     2722    1262 53.6% 10-Nov-96 21:05:46 +hscdepp.hsc
  243.     4557    1870 58.9% 24-Nov-96 15:21:38 +hscpitt.hsc
  244.      833     431 48.2% 21-Oct-96 02:11:16 +index.hsc
  245.      996     559 43.8% 28-Jul-96 22:55:02 +make.hsc
  246.     3677    1554 57.7% 09-Aug-96 16:16:54 +makefile.hsc
  247.     1904     958 49.6% 30-Sep-96 04:15:16 +prjfile.hsc
  248.     6726    3102 53.8% 06-Nov-96 21:23:10 +questions.hsc
  249.      196     147 25.0% 09-Sep-96 07:44:00 +README
  250.      463     235 49.2% 10-Sep-96 13:12:00 +README.info
  251.     2571    1335 48.0% 06-Nov-96 22:22:06 +related.hsc
  252.     1757     966 45.0% 21-Oct-96 02:26:50 +require.hsc
  253.     1252     726 42.0% 06-Nov-96 22:33:26 +source.hsc
  254.      859     526 38.7% 12-Oct-96 21:46:00 +updates.hsc
  255. -------- ------- ----- --------- --------
  256.   645849  288893 55.2% 07-Dec-96 03:06:10   155 files
  257.